Skip to content

Conversation

@Lekensteyn
Copy link
Contributor

The containers-storage(1) and many other manual pages were unreadable. These files only have section headings (## in Markdown, .SH in roff) and lack a title heading (#, .TH). Fix all of these instances with:

sed -re '1s/^## (.+)/# \1/' storage/docs/containers-storage*.md -i

containers-storage.conf.5.md was somewhat readable, but was also fixed up for consistency. Remove author info, already present in footer. A similar problem in the common and image docs was ignored.

These manual pages still have some formatting issues, but this resolves the main one. No idea whether this documentation is still up-to-date.

Fixes: #103

The containers-storage(1) and many other manual pages were unreadable.
These files only have section headings (`##` in Markdown, `.SH` in roff)
and lack a title heading (`#`, `.TH`). Fix all of these instances with:

    sed -re '1s/^## (.+)/# \1/' storage/docs/containers-storage*.md -i

containers-storage.conf.5.md was somewhat readable, but was also fixed
up for consistency. Remove author info, already present in footer.
A similar problem in the common and image docs was ignored.

These manual pages still have some formatting issues, but this resolves
the main one. No idea whether this documentation is still up-to-date.

Fixes: containers#103
Signed-off-by: Peter Wu <[email protected]>
@github-actions github-actions bot added the storage Related to "storage" package label Oct 19, 2025
Copy link
Contributor

@mtrmac mtrmac left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@mtrmac mtrmac merged commit 504baeb into containers:main Nov 3, 2025
36 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

storage Related to "storage" package

Projects

None yet

Development

Successfully merging this pull request may close these issues.

manpage print space is messed up

2 participants